home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / DA / E-Fo / Edit_II.cpt / Edit II ReadMe next >
Encoding:
Text File  |  1990-11-22  |  7.0 KB  |  187 lines  |  [TEXT/EDIT]
  1. Edit II Version 1.0.2 November 22, 1990
  2. ~~~~~~~~~~~~~~~~~~~~~
  3. Written by Kenneth Seah
  4. Copyright © 1990 by Kenneth Seah
  5. (Portions © by Symantec - Written using Think C and Capps’ Editor Toolkit)
  6.  
  7. This application is copyrighted by Kenneth Seah and is distributed as shareware.
  8. You are welcome to try out Edit II for a week or two and if you decide that its
  9. something you want to use, send a check drawn on a US Bank or a draft
  10. for US$15 made out to me at the address below, enclosing the little questionaire.
  11. Otherwise, give a copy of it to a friend, enclosing this file too and trash your
  12. copy (since it takes up valuable space on your disk).
  13.  
  14. I'll consider that you have been registered once you have sent in your shareware
  15. fee.  Upgrades will be posted to GEnie and UseNet.  I can work out a 'site
  16. licence' fee if you need several copies installed at your place.
  17.  
  18. For commercial distribution and correspondence, please contact:
  19.  
  20. Kenneth Seah
  21. P O Box 8565
  22. Austin, TX 78713-8565
  23.  
  24. GEnie: K.SEAH
  25.  
  26. 0. Introduction
  27. ~~~~~~~~~~~~~~~
  28. Edit II is intended as a replacement for the Consulair Edit text editor but
  29. which alllows the use of the cursor keys on the Mac keyboard for navigation.
  30. If the extended keyboard is used, then the num lock LED will indicate whether
  31. the cursor pad or the numeric pad mode is on.  The home, end, page up, page
  32. down keys will also work, as will the delete right key.  One level of undo
  33. is supported.  You can launch Edit II by double clicking old Edit files
  34. (since Edit II uses the same creator signature as Edit, that is, EDIT).
  35.  
  36. Edit II requires System Software 4.1 and above and is Multifinder-friendly.
  37.  
  38. This program is compiled using Think C 4.0.2 and uses the Capps’ Editor
  39. Toolkit.
  40.  
  41. 1. Menu Items
  42. ~~~~~~~~~~~~~
  43. Edit II works just like Consulair's Edit.  The File menu is standard and carries
  44. the usual options of New, Open, Save, Save As, Revert, Page Setup, Print, Transfer
  45. and Quit.  The Edit Menu is also standard and comes with the Undo, Cut, Copy, Paste
  46. and Clear choices.  You can also shift a selection one space to the left or right
  47. using the shift left/right menu items  The Search menu looks a lot like that in
  48. Think Pascal or C.  The Find dialog allows for searching in multiple files.
  49. Click on the multiple file checkbox and specify the file paths or click on the
  50. Use File button to specify the folder using the good old File Selection box).
  51. Quick movements to any part of the file are handled by the Go to options in the
  52. Search menu.  The Font and Size selection is made off the Options menu as submenus.
  53. Options also allows setting of tabs, autoindent choice and the creator of the
  54. saved file (defaults to EDIT).  The Windows menu allows quick selection of one
  55. of the four windows available to Edit II (sorry but this is the maximum number
  56. of editable windows so far).
  57.  
  58. 2. Nice things
  59. ~~~~~~~~~~~~~~
  60. Cursor keys on the Plus and up now work (unlike in Edit).  In addition, if you
  61. have an extended keyboard, then the page up/down, home/end and delete to right
  62. keys also work.  Moreover, the keypad also toggles from the num lock mode (default)
  63. to cursor mode (like on the other machines) when you hit the num lock (clear) key
  64. on the keypad.  A special CursorPad menu will appear showing the correspondence
  65. between the cursor pad and the keys on the number pad.
  66.  
  67. The F1-F4 keys also function as undo, cut, copy and paste on the extended keyboard
  68. and the num lock light on the keyboard will show the state of the number pad.
  69.  
  70. If autoindent mode is on, then hitting option-return will move the insertion
  71. point to the start of the next line and not do the autoindent for that line.
  72.  
  73. 3. GREP searching and replacement
  74. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  75. GREP searching can be now done using regular expressions like the Unix GREP tool.
  76. Pattern matching of regular expressions is carried out as follows:
  77.  
  78. Patterns (regular expressions)
  79.  
  80. 1. Any non-special character is a regular expression which matches itself.
  81.    Characters [ ] \ and . are special characters and should be
  82.    preceded by \ (see rule 4).
  83.  
  84. 2. A regular expression can be concatenated with another regular expression.
  85.  
  86. 3. The . (period) is a special character which matches any one character.
  87.  
  88. 4. The \ followed by any character except ( ) < > or one of the digits 1-9
  89.    is a regular expression which matches that character.
  90.  
  91. 5. A string of characters s surrounded by brackets [ ] forms a regular
  92.    expression that exactly matches any one of the characters in s.  The
  93.    regular expression [^ß] matches any character not in the string ß.
  94.    If a string of 3 characters a-b occurs in the string, then this represents
  95.    all the characters from a to b inclusive.
  96.  
  97. 6. A regular expression R followed by * forms a regular expression which matches
  98.    zero or more occurences of R.
  99.  
  100. 7. A regular expression surrounded by \( and \) matches whatever the regular
  101.    expression matches.
  102.  
  103. 8. A \ followed by a digit n 1 to 9 is a regular expression which matches
  104.    whatever the nth subexpression surrounded by \( \) matches.
  105.  
  106. 9. A regular expression surrounded by \< and \> constrains the match to
  107.    occur when the regular expression is immediately preceded and followed
  108.    by characters which do not match [A-Za-z0-9_] and the first and last
  109.    characters match [A-Za-z0-9_].  This allows us to look for "words".
  110.  
  111. 10. A regular expression which starts with ^ anchors the search pattern to
  112.     the start of a line.  The ^ appearing anywhere else in the regular
  113.     expression will match the ^.
  114.  
  115. 11. A regular expression ending in $ will anchor the search pattern to the
  116.     end of a line.  The $ appearing anywhere else in the regular
  117.     expression will match the $.
  118.  
  119. Replacements
  120.  
  121. 1. Each occurence of & in the replacement string will be substituted with
  122.    whatever was last matched by the regular expression.
  123.  
  124. 2. Each occurence of the form \n where n is a digit 1 to 9 will substitute
  125.    whatever was matched by the nth subexpression enclosed in \( and \).
  126.  
  127. 3. Each occurence of the form \p where p is not a digit 1 to 9 will
  128.    substitute that character p.
  129.  
  130. 4. Creator names
  131. ~~~~~~~~~~~~~~~~
  132. EDIT: Consulair Edit (and Edit II)
  133. MPS : Apple MPW
  134. KAHL: Think C
  135. PJMM: Think Pascal
  136. MACA: MacWrite
  137. MSWD: Microsoft Word
  138. nX^n: WriteNow
  139. ttxt: TeachText
  140. PEDT: DA Edit or PEdit
  141. WNGZ: WingZ
  142.  
  143. 5. Bug Reports
  144. ~~~~~~~~~~~~~~
  145. If you find any bugs with this program, please write to me at the above address.
  146. You can also E-mail me on GEnie as K.SEAH.
  147.  
  148. 6. Questionaire
  149. ~~~~~~~~~~~~~~~
  150. Copy, print this and fill in the blanks!
  151.  
  152. NAME:
  153.  
  154. ADDRESS:
  155.  
  156.  
  157.  
  158. CITY:                         STATE:                ZIP:
  159.  
  160. Macintosh you have:
  161.  
  162. Current version of your System Software:
  163.  
  164. Comments about Edit II (add more space if desired!):
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172. >>> Don't forget the US$15 shareware fee <<<
  173.  
  174. Version History
  175. ~~~~~~~~~~~~~~~
  176. 1.0.1 (10/09/90)
  177. ~~~~~
  178. First release.
  179.  
  180. 1.0.2 (11/20/90)
  181. ~~~~~
  182. Now recognizes the extended keyboard del, home, end, pgup and pgdn keys
  183. while in the Cursor Pad mode.  Fixed toggling of LEDs.  Added Enter Selection
  184. menu item in Search menu to allow for copying of the selected text into the
  185. Search String box in the Find dialog (a la Think C).  You can enter the selected
  186. text and then use Find Again to look for its next occurence.
  187.